USPS Pricing Engine SDK 


July 11, 2019 


Summary 
This is the International Pricing Engine SDK (version 11.7.4.0) for the July 26, 2019 Release. The following 
is a list of enhancements included in this release. 


TT16965 Kahala interface and the Price Engine 

The international price engine has migrated its Kahala Guaranteed Calculator services to use the new 
SDC Guaranteed Calculator Wrapper/SDC interface. This is a change to how the price engine formats 
requests to the SDC API. Itis an internal change and should not impact your systems. 


All methods in the Service Delivery Extensions library were updated to support the new request format. 
You should test the following methods: 

e GetStatesOrProvinces 

e § GetCity 

e GetPostalCodes 

e GetExpressMailGuaranteed 


Additionally, the GetExpressMailGuaranteed allows the caller to specify a Sunday mailing, pre-dating 
and post-dating. These changes will mean that when you use the new interface you should not receive 
the following errors: 

e -10170 Shipping Date cannot be less than today’s date. 

e -10171 Shipping day cannot be a Sunday. 
Any errorsyou do receive related to this functionality will be from Kahala. 


DLL versions to remain 11.7.0.0 
All the libraries will remain 11. 7.0.0. 


Impact on Existing Applications 
You will have to rebuild your applications. 


You will need to add two new application settings to your configuration files: 
<appSettings> 
<add key="ServiceDeliveryCalculator. Available. International" value="true"/> 
<add key="ServiceDeliveryCalculator. Provider .International" value="GCW"/> 
</appSettings> 


The “ServiceDeliveryCalculator .Available. International” setting indicates if international 
guarantee services are available/desirable. 
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The “ServiceDeliveryCalculator .Provider. International” setting instructs the engine to use the 
new SDC Guarantee Calculator Wrapper request methods. “KPG” is another valid value. This instructs 
the engine to use the prior KPG request interface. 


You will need to indicate the web service reference points in the “system.ServiceModel” as well. These 
include: 


Endpoints 


SIT Environment Endpoint 


<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<!-- Kahala GCWrapper version --> 
<binding name="GCWrapperSOAPInterfaceBinding” maxReceivedMessageSize="2147483647" maxBufferPoolSize="2147483647"> 
<readerQuotas maxArrayLength="2147483647" maxStringContentLength="2147483647" /> 
</binding> 
</basicHttpBinding> 
</bindings> 
<behaviors /> 
<client> 
<!-- Kahala GCWrapper version --> 
<endpoint address="http://eagnmnmbd281. usps. gov:9080/sdc-services/services/sdcInternationalPassthrough” 
binding="basicHttpBinding” bindingConfiguration="GCWrapperSOAPInterfaceBinding” 
contract="International.KPG.GCWrapper.GCWrapperSOAPInterface_SEI” 
name="GCWrapperSOAPInterface” /> 





</client> 
</system.serviceModel> 


NOTE: This is a non-SSL service reference. 
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CAT Environment Endpoint 


<system. serviceModel> 
<bindings> 
<basicHttpBinding> 
<!-- Kahala GCWrapper version --> 
<binding name="GCWrapperSOAPInterfaceBinding” maxReceivedMessageSize="2147483647" maxBufferPoolSize="2147483647"> 
<readerQuotas maxArrayLength="2147483647" maxStringContentLength="2147483647" /> 
<security mode="Transport”> 
<transport clientCredentialType="Certificate"/> 
</security> 
</binding> 
</basicHttpBinding> 
</bindings> 
<behaviors> 
<endpointBehaviors> 
<!-- Kalaha GCW version --> 
<behavior name="endpointCredentialBehaviorGCw"> 
<clientCredentials> 
<clientCertificate 
storeLocation="LocalMachine” 
storeName="Root” 
x5@9FindType="FindByThumbprint” 
FindValue="74F9F52cd3789F5c80c821d62534769Fc8c70851" /> 
</clientCredentials> 
</behavior> 
</endpointBehaviors> 
</behaviors> 
<client> 
<!-- Kahala GCWrapper version --> 
<endpoint address="https://sdcl-cat.usps.gov/sdc-services/services/sdcInternationalPassthrough” 
behaviorConfiguration="endpointCredentialBehaviorGCw” 
binding="basicHttpBinding” 
bindingConfiguration="GCWrapperSOAPInterfaceBinding” 
contract="International.KPG.GCWrapper .GCWrapperSOAPInterface_SEI” 
name="GCWrapperSOAPInterface” /> 
</client> 
</system.serviceModel> 
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PROD Environment Endpoint 


<system.serviceModel> 
<bindings> 
<basicHttpBinding> 
<!-- Kahala GCWrapper version --> 


<binding name="GCWrapperSOAPInterfaceBinding” maxReceivedMessageSize="2147483647" maxBufferPoolSize="2147483647": 
<readerQuotas maxArrayLength="2147483647" maxStringContentLength="2147483647" /> 


<security mode="Transport™> 


<transport clientCredentialType="Certificate"/> 


</security> 
</binding> 
</basicHttpBinding> 
</bindings> 
<behaviors> 
<endpointBehaviors> 
<!-- Kahala GCW version --> 
<behavior name="endpointCredentialBehaviorGCw" > 
<clientCredentials> 
<clientCertificate 
storeLocation="LocalMachine”| 
storeName="Root” 
x5@9F indType="FindByThumbprint” 


FindValue="7a4e8399671601F90e3099F456F@F81155536b7e" /> 


</clientCredentials> 
</behavior> 
</endpointBehaviors> 
</behaviors> 
<client> 
<!-- Kahala GCWrapper version --> 


<endpoint address="https://sdcl.usps.gov/sdc-services/services/sdcInternationalPassthrough” 


behaviorConfiguration="endpointCredentialBehaviorGcw” 


binding="basicHttpBinding” 


bindingConfiguration="GCWrapperSOAPInterfaceBinding” 
contract="International.KPG.GCWrapper.GCWrapperSOAPInterface_SEI” 


name="GCWrapperSOAPInterface” /> 
</client> 
</system.serviceModel> 


Instructions 
1. Copy the DLLs 
2. Rebuild you application 
3. Update your application configuration file. 


Contents 


Description 

Folder 
International Business Rate Engine 
Service Delivery Extensions 

Folder 
Release Notes 


DLL 

RateEngine_IntlBusiness. dll 
ServiceDeliveryExtensions.dll 
Documentation 

USPS Pricing Engine SDK 11_7_4 O.pdf 


Reported Defects and Change Request 


None at this time f 
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Configuration text provided for convenience 
SIT configuration text 


<system. serviceModel> 
<bindings> 
<basicHttpBinding> 
<!-- Kahala GCWrapper version --> 
<binding name="GCWrapperSOAPInterfaceBinding” 
maxReceivedMes sageSize="2147483647" maxBufferPoo1Size="2147483647"> 
<readerQuotas maxArrayLength="2147 483647" 
maxStringContentLength="2147483647" /> 
</binding> 
</basicHttpBinding> 
</bindings> 
<behaviors /> 
<client> 
<!-- Kahala GCWrapper version --> 
<endpoint address="http://eagnmnmbd281 .usps. gov: 9080/ sdc- 
services/services/sdcInternationalPassthrough" 
binding="basicHttpBinding" 
bindingConfigurat ion="GCWrapperSOAPInterfaceBinding" 


contract="International .KPG.GCWrapper.GCWrapperSOAPInterface_SEI" 
name="GCWrapperSOAPInterface" /> 
</client> 
</system.serviceModel > 


CAT configuration Text 


<system. serviceModel> 
<bindings> 
<basicHttpBinding> 
<!-- Kahala GCWrapper version --> 
<binding name="GCWrapperSOAPInterfaceBinding” 
maxReceivedMes sageSize="2147483647" maxBufferPoolSize="2147483647"> 
<readerQuotas maxArrayLength="2147 483647" 
maxStringContentLength="2147483647" /> 
<security mode="Transport"> 
<transport clientCredentialType="Certificate"/> 
</security> 
</binding> 
</basicHttpBinding> 
</bindings> 
<behaviors> 
<endpointBehaviors> 
<!-- Kalaha GCW version --> 
<behavior name="endpointCredentialBehaviorGCw" > 
<clientCredentials> 
<clientCertificate 
storeLocation="LocalMachine" 
storeName="Root" 
x509FindType="FindByThumbpr int" 


findValue="74f9F5 2cd3789f 5c80c821d62534769Fc8c 70851" /> 
</clientCredentials> 
</behavior > 
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</endpointBehaviors > 
</behaviors> 
<client> 
<!-- Kahala GCWrapper version --> 
<endpoint address="https://sdc1-cat. usps .gov/sdc - 
services/services/sdcInternationalPassthrough" 
behaviorConfiguration="endpointCredentialBehaviorGCw" 
binding="basicHttpBinding" 
bindingConfiguration="GCWrapperSOAPInterfaceBinding" 
contract="International .KPG.GCWrapper.GCWrapperSOAPInterface_ SEI" 
name="GCWrapperSOAPInterface" /> 
</client> 
</system.serviceModel > 


PROD configuration text 


<system. serviceModel> 
<bindings> 
<basicHttpBinding> 
<!-- Kahala GCWrapper version --> 
<binding name="GCWrapperSOAPInterfaceBinding" 
maxReceivedMes sageSize="2147483647" maxBufferPo0o1Size="2147483647"> 
<readerQuotas maxArrayLength="2147 483647" 
maxStringContentLength="2147483647" /> 
<security mode="Transport"> 
<transport clientCredentialType="Certificate"/> 
</security> 
</binding> 
</basicHttpBinding> 
</bindings> 
<behaviors> 
<endpointBehaviors> 
<!-- Kahala GCW version --> 
<behavior name="endpointCredentialBehaviorGCw" > 
<clientCredentials> 
<clientCertificate 
storeLocation="LocalMachine" 
storeName="Root" 
x509FindType="FindByThumbpr int" 


findValue="7a4e83 99671601 £9 0e 3099F456F8F81155536b70" /> 
</clientCredentials> 
</behavior > 
</endpointBehaviors > 
</behaviors> 
<client> 
<!-- Kahala GCWrapper version --> 
<endpoint address="https://sdc1.usps.gov/sdc - 
services/services/sdcInternationalPassthrough" 
behaviorConfiguration="endpointCredentialBehaviorGCw" 
binding="basicHttpBinding"” 
bindingConfiguration="GCWrapperSOAPInterfaceBinding" 
contract="International .KPG.GCWrapper.GCWrapperSOAPInterface_SEI" 
name="GCWrapperSOAPInterface" /> 
</client> 
</system.serviceModel > 
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